Chapter 3-16: Using GUI Features of the Image Editor |
Painting Pictures A picture object is used to add static graphic designs to a menu, input, output, or inquiry process, or to provide visual detail regarding, for example, a place, a product, or a person. To do so, you must first know the name and location (folder name) of the graphics file you want to add to the image. An example input process with a picture on the image is shown below.
An Input Image Containing a Picture Icon The overlay shown below was used to define the picture for this image. The Picture Properties overlay appears after you select your picture region, as described in Painting Buttons, Labels, Pictures, and Boxes. Notice that a Resource Name was used to identify the picture which is to be displayed. Picture objects are static and do not change at runtime. Picture objects can be used to display various types of static picture objects such as the corporate logo, a picture of the company's headquarters building, or a picture of the company's founding father.
Pictures Properties Overlay The Picture Properties overlay contains several fields that are used to define the characteristics of a picture. Control Options
Position indicates where the picture should appear inside the selected region. Click the list Resource specifies the application and name of a resource defined in Named Resources which links to one or more graphics files. Different graphics can apply depending upon resource state (disabled, enabled, rollover, pressed, etc).
Image Scale defines the size of this appearance of the graphic as a percentage of the normal graphic. Click the list Margin (Top, Bottom, Left, Right sets extra margin space between the picture and the border of the region. This value is in pixels and must be less than or equal to 255. Tooltip defines one line of help text that is displayed after the mouse pointer has been positioned over the picture for a few seconds. Tooltip does not apply to pictures on output and inquiry images. Font Options Font is not a valid option when defining a picture and is disabled. Style is not a valid option when defining a picture and is disabled. Scale is not a valid option when defining a picture and is disabled. Text Color is not a valid option when defining a picture and is disabled. Fill Color defines the region's fill color. Click the color icon to begin and see the Making Color Selections section for further instructions. Transparent? indicates whether or not the background of the region should be opaque or transparent. Border Options
Type defines the type of border that will surround the region. Click the list Color defines the color of the border. Click the color icon to begin and see the Making Color Selections section for further instructions. Tab Order Options Tab Level is not a valid option when defining a picture and is disabled. Tab Group is not a valid option when defining a picture and is disabled. Other Options Enabled is not a valid option when defining a picture and is disabled.
Invisible indicates whether or not the picture is initially invisible when this image is first presented to the user. If 'yes' then the picture must be made visible via ILF code in order for the user to see it. Click the checkbox to toggle between 'yes' Sep. Before? is not a valid option when defining a picture and is disabled. Sep. After? is not a valid option when defining a picture and is disabled. Micro Adjustments Row, Col, Height, and Width make slight adjustments to the size and position of the picture. They are entered as a percentage of an image cell (1 row x 1 column) and must be less than or equal to 100. Name allows you to 'name' the picture so it can be controlled (enabled, disabled, etc.) via ILF statements. Access to the GUI attributes at runtime with ILF code is done via the --- WIDGET file. The WIDGET records from the process are copied into this file and are available in the Pre-Display event point. WIDGET NAME is a key to this file. You can read and rewrite records in this file to affect the GUI attributes at runtime. When you have finished defining the picture you have two options available to you: Select the Save option on the bottom right corner of the screen to save the definition and return to the Image Editor. Or, you can select the Cancel option to discard the new definition or changes to an existing definition, and then return to the Image Editor. Setting the Picture Position attribute field at runtime via ILF requires setting three Widget File fields as illustrated in the following diagram. See The WIDGET File/Record page in this chapter for more information on altering the WIDGET file at runtime. Widget field settings |
Application Design Manual "Powered by Appx Software"450 ©2006 By APPX Software, Inc. All Rights Reserved |
button for a drop-down list of selections that include CENTER, TOP, RIGHT, BOTTOM, LEFT, UPPER RIGHT, UPPER LEFT, LOWER RIGHT and LOWER LEFT.
and 'no' 
values.